home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / standard / ldtbread.z / ldtbread
Encoding:
Text File  |  1998-10-30  |  3.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. LLLLDDDDTTTTBBBBRRRREEEEAAAADDDD((((3333XXXX))))                                                      LLLLDDDDTTTTBBBBRRRREEEEAAAADDDD((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ldtbread - read an indexed symbol table entry of a common object file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ffffiiiilllleeeehhhhddddrrrr....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyymmmmssss....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<llllddddffffccccnnnn....hhhh>>>>
  16.  
  17.      iiiinnnntttt llllddddttttbbbbrrrreeeeaaaadddd ((((ldptr, symindex, symbol))))
  18.      LLLLDDDDFFFFIIIILLLLEEEE ****ldptr;;;;
  19.      lllloooonnnngggg symindex;;;;
  20.      ppppSSSSYYYYMMMMRRRR symbol;;;;
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      _l_d_t_b_r_e_a_d reads the symbol table entry specified by _s_y_m_i_n_d_e_x of the common
  24.      object file currently associated with _l_d_p_t_r into the area of memory
  25.      beginning at _s_y_m_b_o_l.
  26.  
  27.      _l_d_t_b_r_e_a_d returns SSSSUUUUCCCCCCCCEEEESSSSSSSS or FFFFAAAAIIIILLLLUUUURRRREEEE.  If _s_y_m_i_n_d_e_x is greater than the
  28.      number of symbols in the object file or if it cannot read the specified
  29.      symbol table entry, _l_d_t_b_r_e_a_d fails.
  30.  
  31.      The local and external symbols are concatenated into a linear list.
  32.      Symbols are accessible from symnum zero to
  33.      _S_Y_M_H_E_A_D_E_R(_l_d_p_t_r)._i_s_y_m_M_a_x+_S_Y_M_H_E_A_D_E_R(_l_d_p_t_r)._i_e_x_t_M_a_x.  The index and iss
  34.      fields of the SYMR are made absolute (rather than file relative) so that
  35.      routines _l_d_g_e_t_n_a_m_e(3X), _l_d_g_e_t_a_u_x(3X), and ldtbread (this routine) proceed
  36.      normally given those indices.  Only the ``sym'' part of externals is
  37.      returned.
  38.  
  39.      NNNNOOOOTTTTEEEE: The first symbol in the symbol table has an index of _z_e_r_o.
  40.  
  41.      The program must allocate space big enough for a SSSSYYYYMMMMRRRR and point the ppppSSSSYYYYMMMMRRRR
  42.      argument at the space before calling _l_d_t_b_r_e_a_d.
  43.  
  44.      The program must be loaded with the object file access routine library
  45.      lllliiiibbbbmmmmlllldddd....aaaa.
  46.  
  47. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  48.      ldclose(3X), ldgetname(3X), ldopen(3X), ldtbseek(3X), ldfcn(4).
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.